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Abstract 

The orbifolder is a program developed in C++ that computes and analyzes the low-energy effective theory 
of heterotic orbifold compactifications. The program includes routines to compute the massless spectrum, 
to identify the allowed couplings in the supeipotential, to automatically generate large sets of orbifold 
models, to identify phenomenologically interesting models (e.g. MSSM-like models) and to analyze their 
vacuum-configurations. 
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Program Summary 

Program title: orbifolder 

Program obtainable from: http : //pro j ects . hepf orge . org/orbif older/ 
Distribution format: tar.gz 
Programming language: C++ 
Computer: Personal computer 

Operating system: Tested on Linux (Fedora 15, Ubuntu 11, SuSE 11) 
Word size: 32 bits or 64 bits 
External routines: None 
Dependencies: Boost, GSL 

Typical running time: Less than a second per model. 

Nature of problem: Calculating the low energy spectrum of heterotic orbifold compactifications. 
Solution method: Quadratic equations on a lattice; representation theory; polynomial algebra. 
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1. Introduction 

String theory is a candidate for a consistent unified quantum theory of gravity and gauge interactions 
and could thus provide us with an ultraviolet completion for models of particle physics. The search for 4- 
dimensional string vacua resembling the standard model (SM) (or its supersymmetric extension (MSSM)) 
is therefore one of the central questions in string theory research. Over the years, a wide landscape of 4- 
dimensional string models has emerged and it remains to be seen how particle physics phenomena can be 
incorporated within the scheme of string theory. Some hints point to a unification of gauge couplings within 
the framework of exceptional groups (as e.g. Eg) but a direct road from strings to particle physics has not 
yet been identified. It is perhaps the time to step back, collect and classify existing model constructions and 
try to identify properties relevant for a description of nature. 

Here we present and analyze a specific approach that was studied already in the 1980s and has led 
to interesting results since then: orbifold compactification [1, 2, 3] of the heterotic strings [4, 5]. The 
reason for the success of this approach is "computability" paired with geometric intuition. Exact tools of 
conformal field theory are here at our disposal [6, 7] that are usually not available in approaches based on 
compactification on smooth manifolds. Besides, in particular E§ x Eg as a gauge group allows a perturbative 
inclusion of the standard model gauge group (as well as possibly grand unification). 

A toroidal orbifold is flat with the exception of a number of fixed points or fixed tori. It gives rise to 
a picture called the heterotic brane world scenario [8, 9, 10]: fields can either live in the 10-dimensional 
bulk (untwisted sector) or can be localized at these fixed points or fixed tori (twisted sectors). The relative 
location of these fields as well as the local gauge structure determines many properties of the 4-dimensional 
string vacua and is the source of geometric intuition for model building. The orbifold point is a point of 
enhanced symmetries (in the moduli space of compactification) and those symmetries might be relevant for 
a description of nature. Models of particle physics seem to require many (discrete) symmetries, e.g. flavour 
symmetries or symmetries to prevent too fast proton decay. Some of these symmetries could be slightly 
broken to provide us with small parameters relevant for the description of hierarchies as e.g. observed in 
the spectrum of quark and lepton masses. This supports our hope that orbifold compactification is not just 
an approximation with increased "computability", but that it provides a realistic compactification: nature 
might have chosen to live close to the orbifold point with enhanced symmetries. 

Explicit orbifold model constructions in the last 5 to 10 years have been extremely successful [11, 12, 13, 
14] (see [15, 16] for earlier reviews). Many of the properties of particle physics can be incorporated in the 
scheme. This includes grand unification, gauge- Yukawa unification, satisfactory Yukawa textures, solutions 
to the //-problem, the creation of hierarchies and a successful incorporation of neutrino Majorana masses. 
Discrete symmetries are identified to solve the flavour problem and to avoid too fast proton decay. These 
properties have been identified in the so called Minilandscape (based on the Z6-II orbifold) [17, 18, 19] and 
subsequent work [20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33]. 

The search for such models requires a computer assisted scan that incorporates the rules for a consistent 
string theory construction (as e.g. modular invariance). The purpose of this work is to make the tools and 
techniques available to the public. We hope that this will give more people the opportunity to contribute to 
this exciting field of model constructions. 

We present the orbif older, a program developed in C++ that allows the calculation of the low-energy 
spectrum of heterotic orbifold constructions. The program includes routines to compute the massless spec- 
trum and to identify the allowed couplings of the superpotential. It allows the construction of arbitrary 
orbifold models, the identification of phenomenologically interesting models and a classification of their 
vacuum configurations. 

The orbif older can be considered in some aspects as the stringy analog of programs such as Sof tSusy, 
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SuSpect and SPheno: The latter are devoted to the detailed computation of particle spectra, interactions and 
phenomenological quantities, using as input a high scale supersymmetric model and imposing low-energy 
constraints. Analogously, the orbif older takes as a starting point the 10D heterotic strings and, provided 
some geometric input describing the features of the six compactified dimensions, computes the (massless) 
spectrum, interactions and symmetries of the resulting lower-energy effective 4D field theory. 

After a short introduction to heterotic orbifold compactification in Section 2, we explain how to down- 
load and install the C++ program in Section 3. Section 4 discusses the explicit recipe to run the program, 
while in Section 5 we conclude and give an outlook for future research. Technical details are relegated to 
the appendices and to the webpage [39, Complementary notes]. 

2. Heterotic Orbifold Compactifications 

In this section we give a brief introduction to heterotic orbifolds, in order to introduce our notation 
and conventions used in the orbif older. For more details on orbifold compactifications, we refer to the 
reviews [15, 16, 11, 13, 14]. 

In the context of heterotic string compactifications, we define an orbifold as the quotient of six-dimen- 
sional real space R 6 divided by the so-called space group S , where the quotient is taken using the equiva- 
lence relation X ~ gX for all g e S and X e R 6 . More specifically, the space group is chosen to consist of 
two parts: 

• discrete rotations that form the so-called point group P. For simplicity, we choose P to be Abelian. 
To obtain N - 1 supersymmetry in 4D, P is either %m or TLm^^n generated by rotation matrices 9 
and a), where we use a> = 1 for %m- These matrices can be represented by so-called twist vectors v\ 
and V2 that give the three rotational phases in the three complex planes and the sum over all entries 
integer to ensure N = 1. For example, vi = (0, |, |, -|J and V2 = for the Z3 orbifold. 

• translations generated by the vectors e a € IR 6 , for a = 1, . . . , 6. They form a 6D lattice denoted by T 
and hence define a six-torus. Elements of P must map the lattice T to itself. 

In detail, an element of the space group is of the form g = i&oJ , n a e a ^j e S , where k,l e TL, n a e % (or in 
some cases n a e Q) and summation over a - 1, . . . , 6. It acts onXeK 6 as gX = 9 k a> 1 X+n a e a . Using these 
definitions, we can deal with all 6D Abelian and toroidal orbifolds including the cases of roto-translations 
and freely acting involutions (see e.g. Ref. [34]). 

Due to modular invariance, the geometric action of the space group S has to be embedded into the 
gauge degrees of freedom of the heterotic string, denoted by X 1 , 1 = 1, . . . , 16 in the bosonic formulation. 
We restrict ourselves to the case of shift embedding, where 6 V\, a> V% and e a e -» W a for a = 1 , . . . , 6. 
Then, the action of 5 on X e R 6 induces an action on X 1 as 

gX = ^Jx + n a e a => g X 1 = X 1 + kV[ + W[ + n a W' a , (1) 

where / - 1, . . . , 16. The vectors V\, V% and W a are called shifts and Wilson lines, respectively. They are 
constrained by modular invariance [2, 35, 36], e.g. 

M (V? - vf) - mod 2 and N a W 2 a = mod 2 , (2) 

where M is the order of %m and _/V a the order of W a . The combined group formed by the space group and 
its action on the gauge degrees of freedom is called the orbifold group. 
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From a model-building standpoint, we have now introduced all the input data to define a heterotic 
orbifold model: the space group S (consisting of the point group P and the lattice Y) and its embedding as 
shifts V\, V2 and Wilson lines W a . 

We close this section with a very brief summary of the construction of massless spectra of heterotic 
orbifolds. Given the input data, one distinguishes between two kinds of closed (and massless) strings on 
the orbifold: first of all ordinary closed strings, also called untwisted strings, being the remnants of the lOd 
EgxEg or SO(32) vector multiplet and the gravity multiplet. Secondly, there are closed strings from the 
twisted sectors which close only up to the action of the orbifold group. To construct them, one needs to 
identify the inequivalent non-trivial space group elements as the constructing elements of twisted strings: 
i.e. for g € 5 one can define a twisted boundary condition X(t, cr + n) = gX(r, cr) on the string world-sheet. 
Then, using standard CFT techniques, the equations for massless right- and left-movers with boundary 
condition g read 

\2 



- - + 8c = and - — — + N- l+5c = (3) 

2 2 2 

where p is from the E§ x Es or Spin(32)/Z2 weight lattice, q from the vector or spinor weight lattice of 

SO(8), 5c denotes the shift in the zero-point energy and N the number operator of left-moving oscillators. 

Furthermore, we define the local twist v g = kv\ + IV2 and the local shift V g = kV\ + IV2 + n a W a . In the 

final step, one builds massless states as tensor products of massless right- and left-movers such that they are 

invariant under the full orbifold action, i.e. 

\q + v g > R ® \p + V g ) L or \q + v g ) R ® a\p + V g ) L , (4) 

where a denotes possible oscillator excitations. We define the shifted momenta = q + v g and p s ^ = 
p + V g , where p^ describes the transformation properties under gauge transformations. The states Eq. (4) 
correspond to massless fields of the 4D effective field theory. They carry gauge charges (from p s ^), discrete 
R charges, modular weights (from q^ and possible oscillator excitations) and discrete non-7? charges (from 
the constructing element g e S). 



3. Download and Installation 

The minimal requirements for compiling the orbif older are the Boost C++ Libraries version > 1 .0 [37] 
and the GNU Scientific Library (GSL) version > 1.9 [38]. All components should come preinstalled on a 
standard Linux distribution. If this should not be the case, they can easily be installed. 

On a yum-based distribution like e.g. Fedora, the command "y™ -y install gsl gsl-devel boost 
boost-devel" will install the corresponding libraries (recommended). Alternatively, one can also directly 
install from source or use the other download options available [37, 38]. 

The orbif older is free software under the copyleft of the GNU General Public License and can be 
downloaded from [39] : 

http : //projects, hepforge .org/orbif older/ 

To install the program, download the file orbif older- 1.0. tgz to a directory of your choice, open a 
shell and enter the following commands at the prompt: 

1 tar xfvz orbif older— 1 . . tar . gz 

2 cd orbif older-1 . 

3 ./configure 
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4 make 

5 make install 



Note that the version number "1.0" may change over time and should be substituted accordingly. The 
first line unpacks the tar-ball and creates a subdirectory structure with the source code. The second line 
changes to the installation directory. The third line starts the configuration script that checks system re- 
quirements and generates the Makefile. The fourth line compiles the code, and finally the fifth line installs 
it on your system. After successful compilation and installation, the main program (named orbif older) 
will be available in the current directory. We have disabled custom installation using the — prefix switch 
in the configuration script. The main program orbif older can simply be copied to the directory of the 
user's choice by the standard shell commands. Detailed installation instructions can also be found in the 
README file in the installation directory and on the website [39]. 

We have tested the installation process on 

• a 32-bit system running Linux Ubuntu 11.04 with Boost 1.42 and GSL 1.14, 

• a 64-bit system running Linux SuSE 1 1 with Boost 1.36 and GSL 1.11, 

• a 64-bit system running Linux Fedora 15 with Boost 1.46 and GSL 1.14, 

and ascertained that our code compiles correctly. Should there arise any problems during the installa- 
tion, we request that the user send us the file config.log and the output of the make command by email 
(orbif older @ projects, hepforge. org ) . 

4. How to run the program 

There are three main ways to gain access to the orbif older: through the prompt, through a web inter- 
face and directly through the C++ source code. In the following we will present them in detail. 

4.1. The prompt 

The orbif older can be controlled using a Linux-style command line called the prompt. The prompt 
offers an interactive access to almost all variables and functions of the orbif older. It has the structure of 
a file system where orbif old models appear as directories. In the following we explain how to start and use 
the prompt. 

4.1.1. How to get started 

We begin with a small tutorial, see Tab. 4 in the additional material [39, Complementary notes] for 
a sample input and output. In general, the prompt can be started using the command ./orbif older or 
. /orbif older [model file] . In the former case, no model is loaded automatically. In the latter case, the 
details of a model contained in the plain-text-based model file are loaded (Further properties of model files 
are explained in Section 4.4.2). As an example, run the program using the command 

./orbif older modelZ3.txt (5) 

with parameter modelZ3.txt in order to load the standard embedding model of the Z3 orbifold from this 
file. Having started the program, one enters the prompt in its main directory />. The command 
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(6) 



lists all commands and subdirectories of the current directory. In our example, there is one subdirectory in 
the main directory /> called Z3StandardEmbedding which corresponds to the Z3 model loaded. In general, 
a (sub-) directory A can be accessed using the command cd A. In our example, 

cd Z3StandardEmbedding (7) 

results in the output /Z3StandardEmbedding> from where one can access, analyze or change the details of 
the Z3 standard embedding model. Again, type in the command dir to see all commands and subdirectories 
of the current directory. For all orbifold model directories there are five subdirectories, 

/model>, /gauge group>, /spectrum>, /couplings> and /vev-conf ig>, (8) 

containing commands of the respective category: 

• /model>: Print and change the input data of the current orbifold model. See Appendix B.2.2. 

• /gauge group>: Print details on the gauge group, change the U(l) basis and find accidental U(l) 
symmetries. See Appendix B.2.3. 

• /spectrum>: Print details on the spectrum of massless fields. See Appendix B.2.4. 

• /couplings;-: Create and analyze the superpotential and the resulting effective mass matrices. See 
Appendix B.2.5. 

• /vev-conf ig>: Define and analyze various vev-configurations. See Appendix B.2.6. Each configu- 
ration is specified by the distinction between observable and hidden sector of the gauge group and the 
assignment of labels and vacuum expectation values to the fields (labels are assigned in a subdirectory 
called /labels>, see Appendix B.2.7). 

Again, one can access these directories using the cd command. For example, try cd gauge group to enter 
the subdirectory /gauge group> and use the commands print gauge group and print simple roots to 
see the gauge group (Eg x SU(3) x Eg) and (a choice of) the corresponding simple roots. In order to go back 
one directory one uses the command cd . . at the prompt. Next, try the subdirectory /spectrum> and use 
the command print summary to get a summary table of all massless matter fields. The command cd ~ is 
used to go back to the main directory />. Further standard commands of the prompt are described in Tab. 1; 
see also Appendix B for a glossary of commands. 



command 


description 


dir 


display commands and subdirectories of the current directory 


cd A 


change the current directory to A (if A exists) 


cd.. 


go back one directory 


cd~ 


go back to the main directory /> 


exit 


exit the program if no process is running; use the parameter 




orbif older to enforce exit (also inside a script) 



Table 1: Some standard commands in the prompt. 
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4.1.2. How to create new orbifold models 

Being in the main directory /> of the prompt new orbifold models can be accessed basically in three 
ways: 

• load orbif olds (Filename) : Load orbifold models from a model file. For example, load the Z^-II 
orbifold MSSM of [40] using the command load orbif olds (modelBHLR.txt). 

• create orbifold(A) with point group (M, N) : Create a %m or %m>^n orbifold named A by spec- 
ifying M and N (set N = 1 for %m)- After entering the new directory using cd A, one is asked to 
specify more details on the model like shifts and Wilson lines, see Appendix B.2.2. 

• create random orbifold from(A) . See below. 
Orbifold models can be created randomly by using the command 

create random orbifold from(A) (9) 

in the main directory />. The parameter A must be either the name of an existing (loaded or previously 
created) orbifold model or * for any existing orbifold model in the orbif older. The command starts a new 
process that runs in the background so that one can continue to work with the prompt (see Appendix B. 1.5 
for more details on processes). One can specify several optional parameters: 

• if (...) : Specify the desired properties of the model: inequivalent in order to choose only mod- 
els with inequivalent spectra and SM, PS or SU5 for models with a (net) number of X generations of 
Standard Model (SM), Pati-Salam (PS) or SU(5) gauge group plus vector-like exotics, where X is 3 by 
default and can be changed using the parameter Xgenerations; c.f. the command analyze conf ig 
in Appendix B.2.6. 

• save to (Filename) : Save the models with the desired properties to a model file. 

• use(l,l,0,l,...): Eight digits for two shifts plus six Wilson lines; either 1 if the corresponding 
shift/Wilson line shall be taken from model A, or if it shall be created randomly. 

• #models(X): Define how many models (with the desired properties, if specified) shall be created 
randomly. Use #models(all) to create as many models as possible. If #models(X) is not used, only 
one model shall be created. 

• print info: Print a short summary of the spectrum immediately when a new model with the desired 
properties has been found. 

• load when done: Load the created models into the orbif older after the process has finished. 

• do not check anomalies: Use this parameter to speed up the process. 

• compare #couplings of order (X) : If only inequivalent models are saved, this parameter refines 
the comparison between two models: compare in addition the number of all superpotential couplings 
up to the specified order X. Slows down the process considerably. 
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Examples. A typical example of how to use this command looks like 

create random orbifold f rom(Z3StandardEmbedding) if (inequivalent) (10) 
save to (Z3NewModels.txt) use (1 , 1 , , , , ,0 ,0) #models(10) print info 

executed from the main directory />. In this case a new process is started that constructs new Z3 orbifold 
models using both shifts (i.e. V2 = 0) but no Wilson lines from model Z3StandardEmbedding, saves only 
inequivalent models to a model file named Z3NewModels.txt, prints a brief summary of each new model 
and stops after creating ten inequivalent models. In a second example, ten random models of SM (Standard 
Model) type are created starting from the Zg-II orbifold MSSM of [40] by using the command 

create random orbifold f rom(Z6II0rbif old_BHLR) if (inequivalent SM) (11) 
save to(Z6IINewMSSMModels .txt) use (1 , 1 , 1 , 1 , 1 , 1 , ,0) #models(10) 
print info load when done 

in the main directory />. The parameter used, 1,1, 1,1, 1,0,0) specifies that only the Wilson lines W5 
and W(, are created randomly, i.e. the shifts and other Wilson lines are taken from the original model. 
Furthermore, only inequivalent standard models (SM) are printed, saved to file Z6IINewMSSMM0dels.txt 
and finally loaded into the orbif older after the process has finished. Note that these MSSM models should 
be part of the Mini-Landscape [17, 19]. 

4.2. The web interface 

The orbif older can also be accessed through a user-friendly web interface. The orbif older on-line 
makes extensive use of the prompt explained in Section 4. 1 rendering it available to any user with access 
to an internet browser, such as Mozilla Firefox version > 3.6, Google Chrome version > 2.1, and Internet 
Explorer > 8.0. Consequently, the program is also available to users of all kinds of smartphones. 

One of the advantages of the web interface is that one does not need to install any program on the 
local computer to be able to use most of the functions of the orbif older. Another advantage is that it can 
be executed from platforms that work with the most popular operating systems (without further auxiliary 
applications): Windows, Linux and Mac. 

On the less bright side, one shortcoming of this version is that it is not recommended to execute time- 
consuming instructions since short interruptions in the internet service may affect the results. Furthermore, 
a command running during more than 60 minutes is disabled automatically to avoid overload of the server. 
Finally, for security reasons, commands involving file manipulation are extremely limited. Specifically, the 
parameters and commands @begin/@end print to file (Filename), save to(Filename), load/save 
couplings (Filename) , load/save labels (Filename) are disabled. 

The orbif older on-line can be used on our main page [39] 

http : //projects . hepf orge . org/ orbif older/ 
which redirects to any of our mirror servers. To gain access, you must click on the link orbif older 
on-line. This starts an orbif older session on the selected server. The new page consists of three parts: 

• History: The result of the latest instructions is shown. The button download history provides an 
RTF file containing the full history, i.e. not only the result of the latest instructions, but the result of 
all the commands used during the current session. The user can resize this window. 

• List of Commands: This is the input area, where the commands of the prompt are typed. To execute 
them, it is necessary to click on the button execute commands. An additional help in this section is the 
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button upload commands. This button can be used when files (not larger than 100Kb) in plain-text for- 
mat containing (lists of) admissible commands have been prepared. The button download commands 
provides an RTF file containing the list of all the commands typed during the active orbif older 
session. 

Lists of useful commands and their use is provided in Section 4.1 and Appendix B. 

• Help: The bottom part contains a list of all available commands for the current directory. Each 
command in the displayed list is a link to a more precise description of its use. 

To terminate an orbif older on-line session, it suffices to click on the upper button EXIT. The buttons 
provided on the resulting page allow the user to download the full history of the current session and the 
complete list of successfully executed commands. 

Occasionally, errors in the input data may cause the orbif older to crash. In those cases, the web 
interface shall close your session, giving you the opportunity to download the list of instructions (button 
download commands) to be used if you restart the orbif older. Please, make sure that the downloaded list 
of commands does not contain the instructions that led to the failure of the program. We encourage users 
to contact the authors reporting any failure in the program, preferably by using the link contact us on the 
main page of the web interface. 

4.3. The C++ source code 

The orbif older is written in C++, distributed over several files. Many physical quantities, as briefly 
introduced in Section 2, have been encapsulated into classes, for example 

• CSpaceGroup for the space group S and CSpaceGroupElement for its elements g e S, 

• CTwistVector for the twists V; and CShif tVector for the corresponding shifts V,-, 

• CWilsonLines for the set of six Wilson lines W a , 

• COrbif oldGroup for the orbifold group, 

• CMasslessHalf State for finding massless left- and right-movers, i.e. solutions to Eq. (3), 

• CHalf State for the weights of CMasslessHalf State sorted with respect to their transformation prop- 
erties under the elements of the centralizer, 

• estate for orbifold-invariant tensor products of massless left- and right-movers, see Eq. (4), 

• COrbif old for the full orbifold compactification, 

• CField for a field of the effective 4-dimensional theory, 

• CMonomial for (gauge invariant) monomials of fields corresponding to D = solutions, 

and many more. In addition there are technical classes. For example, there are several classes devoted to 
group theory (like dynkin, f reudenthal, gaugeGroupFactor and gaugeGroup), the class CAnalyseModel 
contains functions to analyze models for their phenomenological properties, the class CPrint contains all 
printing commands and the class CPrompt contains the source code of the prompt. As there are in total more 
than 40 classes we cannot explain them in detail here. We give further details of some of the more important 
classes in Appendix A and a short example program in Appendix A. 1 . 
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4.4. Files defining an orbifold model 

There are two files that define an orbifold model: i) The geometry file contains, as the name suggests, 
the geometrical information about the orbifold, such as the space group, and ii) the model file contains shifts 
and Wilson lines, i.e. the action of the orbifold on the gauge sector of the heterotic string. In the following 
we give some more details. Examples are given in the additional material [39, Complementary notes]. 

4.4.1. The geometry file 

The geometry file basically contains information about 

• the space group, i.e. the order of the twist(s), the six lattice vectors of T and the generators of the 
space group, 

• the discrete (R and non-/?) symmetries of the orbifold (important for the computation of allowed 
superpotential couplings), 

• the inequivalent fixed points specified by their constructing elements (9 k <J, n a e a ^ and 

• for each constructing element a list of centralizer elements, i.e. elements h e S with [h, g] = 0. 

We give two examples in the additional material [39, Complementary notes]: Tab. 1 gives a detailed 
description of a geometry file using the example and Tab. 2 explains how to create a new geometry file 
of, for example, model (1-3) of Ref. [34]. 

4.4.2. The model file 

The model file contains a list of orbifold models, where each model is specified by 

• the name of the model (will be used as the name of the corresponding directory in the prompt), 

• the name of the geometry file, 

• the type of heterotic string (i.e. Spin(32)/Z2 or Es x E%), 

• two shifts V\, V% (where the V2 = for %m orbifolds), 

• six Wilson lines W a , 

• optionally, the parameters of (generalized) discrete torsion and d a p as defined in Ref. [36], 

• optionally, some of the U(l) generators, 

• optionally, one can specify a script that is executed automatically after the model has been loaded. 

An example for the case of a Z3 orbifold with standard embedding is given in the additional material [39, 
Complementary notes]. 
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5. Conclusions and outlook 



With the tools provided here it should be possible to thoroughly investigate the landscape (in particular 
the MSSM-like landscape) of orbifold compactification of the heterotic string. This "heterotic braneworld" 
provides a coherent geometric picture of MSSM-like models. Crucial properties of the scheme depend on 
the geography of fields in extra dimensions. This leads to the concept of "Local Grand Unification" and a 
geometric understanding of e.g. Yukawa couplings, the //-term, neutrino masses and proton decay. Detailed 
properties of models can be computed reliably within the context of conformal field theory. 

The models constructed here should be compared (and possibly related) to other regions of the MSSM- 
like landscape, as e.g. fermionic formulations [41, 42, 43], tensoring of conformed field theories [44], 
smooth compactifications of the heterotic string [45, 46, 47, 48, 49, 50], type II (intersecting) brane- 
models [51, 52, 53, 54, 55], M- and F-theory constructions [56, 57, 58, 59, 60, 61, 62]. It would be 
interesting to identify similarities and differences of the corresponding schemes. All these cases rely on 
a (sometimes hidden) geometric interpretation that defines the properties of the models such as the appear- 
ance of grand unification, values of Yukawa-couplings and the existence of hierarchies. 

One of the important observations in the framework of the heterotic braneworld concerns the crucial 
role played by discrete (gauge) symmetries. They arise as remnants of the gauge symmetry as well as sym- 
metries due to the special location of fields in extra dimensions. They control properties of the scheme, 
as e.g. flavor universality and the question of proton stability. At the orbifold point we encounter an en- 
hancement of discrete symmetries and particle spectra. These symmetries are a basic ingredient of model 
building. Slightly broken, they might give us an explanation for the appearance of hierarchies in particle 
physics (as e.g. the ratio of Yukawa couplings). At the orbifold point we can rely on exact conformal field 
theory techniques that could be useful to understand the blow-up procedure [6, 7, 63, 64, 65, 30, 66] of 
orbifold singularities in a controlled way and thus connect to smooth compactifications. 

With a better knowledge of the MSSM-landscape we might hope to relate the various constructions 
and improve the calculational power in those models where we still have to rely on an effective low-energy 
supergravity and/or large volume approximation. The future of the field requires reliable calculational tools 
(as e.g. conformed field theory techniques) which are up to now only applicable in some corners of the 
landscape. But we might be lucky and nature might have chosen to live close to such a corner. 
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Appendix A. Glossary of relevant classes 

The orbif older makes extensive use of the class structure offered by C++. The information of an 
orbifold model is distributed according to the following classes. 

Class CAnalyseModel. The class CAnalyseModel contains several functions that analyze the phenomenol- 
ogy of orbifold models, mainly for the cases of the Standard Model, Pati Salam or SU(5) gauge group. 

Class CField. A CField object contains all physical information about a massless field, such as the rep- 
resentation, the U(l) charges, the q s h charges, the localization and its vev. In addition, it contains a list 
of indices which specify its weights (stored in the member variable vector<CVector> Weights of the 
associated CMasslessHalf State object). 

Class CFixedBrane. A CFixedBrane object contains all information about all (untwisted or twisted) strings 
with constructing element g = [9 k cJ, n a e a ^j e S . The left-moving part of the string is computed using 
the local shift V g - kV\ + IV2 + n a W a . Hence, the solutions of the equation for massless left-movers, 
Eq. (3), are stored here in a vector of CMasslessHalf State objects, one entry for each different choice 
of oscillator excitation. After the massless solutions have been identified, they are sorted with respect to 
their centralizer eigenvalues and stored in a corresponding vector of CHalf State objects (one entry for each 
different choice of N with different eigenvalues). In the last step, the massless right-moving CHalf State 
objects from CSector are tensored together with the massless left-moving CHalf State objects stored here 
to form orbifold-invariant string states. These states are stored in vector<CState> InvariantStates. 

Class CHalf State. A CHalf State object descends from a CMasslessHalf State object by sorting the mass- 
less solutions (i.e. the weights q s h or p s h for right- or left- movers) with respect to their centralizer- 
eigenvalues. The indices of the weights (as listed in vector<CVector> Weights of the corresponding 
CMasslessHalf State object) having the same eigenvalues vector<double> Eigenvalues are stored in 
vector<unsigned> Weights. 

Class CMasslessHalf State. A CMasslessHalf State object stores the solutions of the equation for mass- 
less right- or left-movers, respectively, see Eq. (3). The constructor CMasslessHalf State (MoversType 
Type, const S_OscillatorExcitation feExcitation) needs two parameters: the first parameter Movers- 
Type can be either Lef tMover or RightMover and the second one specifies the oscillator excitation. Then, 
one can call the member function bool SolveMassEquation(const CVector &constructing_Element , 
const Self DualLattice feLattice) to create the solutions of Eq. (3), where constructing_Element de- 
notes the local twist v g or the local shift V g and Self DualLattice can be either E8xE8, Spin32 or SD8. The 
solutions are stored in vector<CVector> Weights. 

Class COrbif old. A COrbif old object contains all information about a single orbifold compactification. 
The main member variable is vector<CSector> Sectors, i.e. a vector of M times N CSector objects, one 
for each sector of a TLm^TLn orbifold. The first element corresponds to the untwisted sector and the rest to 
the various twisted sectors. 

Class COrbif oldGroup. A COrbif oldGroup object basically contains the space group and its gauge embed- 
ding as objects of class CSpaceGroup, CShif tVector and CWilsonLines. Furthermore, it contains a vector 
of all inequivalent constructing elements (vector<COrbif oldGroupElement>) and a corresponding vector 
of centralizer elements (vector<vector<COrbif oldGroupElement> >). 
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Class CPrint. The CPrint class contains all printing commands. For the constructor CPrint (Output Type 
output_type , ostream *out) one needs to specify the Output Type, being either Tstandard, Tmathematica, 
or Tlatex, and a ostream object to set the destination of the output, either to the screen using fecout or to a 
file using an of stream object. 

Class CSector. A CSector object contains all information about an untwisted or twisted sector. It is mainly 
specified by the local twist v g (or in other words by k and / since v g = kv\ + Ivz)- As the oscillator excitations 
and the right-moving part of the string only depend on the local twist, see Eq. (3), they are identical for all 
strings from a given sector. Hence, this data is stored in CSector. 

Class CSpaceGroup. A CSpaceGroup object contains the details about the space group of an orbifold model, 
as explained in Section 2. All constructing and centralizer elements are stored in CSpaceGroupElement 
objects. Additionally, it includes the geometrical information of the compact space, such as the 6D lattice, 
its symmetries and the order of the associated Wilson lines. 

Class estate. A estate object is basically an orbifold-invariant combination of a massless right-moving 
CHalf State object and a massless left-moving CHalf State object. 

Appendix A.l. Example source code 

We present a sample program that computes and analyzes the spectrum of the Z^-II orbifold model of 
[9]. In the source code distribution, the corresponding file is src/examples/samplemainOl . cpp. 

1 #include <stdio.h> 

2 #include "cprompt.h" 

3 using namespace std; 

4 

5 int main(int argc, char *argv[]) 

6 { 



7 if stream inCmodelKRZ_Al.txt"); 

8 if ( ( ! in. is_open() ) II ( ! in. goodO ) ) 

9 exit(l); 

10 

n CPrint Print (Tstandard, fee out ) ; 

12 string ProgramFilename = ""; 

13 

14 COrbif oldGroup Orbif oldGroup ; 

15 if (Orbif oldGroup . LoadOrbif oldGroup (in, ProgramFilename))// load from file 

16 { 

n cout « "\n-> Model file \"modelKRZ_Al . txt\" loaded." « endl ; 

is COrbif old KRZ_A1 (Orbif oldGroup) ; // create the orbifold 

i9 cout « "-> Orbifold \"KRZ_A1\" created. \n" « endl; 

21) 

21 cout << "-> Print shift and Wilson lines:" << endl; 

22 Print . PrintShif t (Orbif oldGroup . GetShif t (0) ) ; 

23 Print . PrintWilsonLines (Orbif oldGroup . GetWilsonLines () , true) ; 

24 

25 cout << "\n-> Print spectrum, first with and then without U(l) charges:" << endl; 

26 Print . PrintSummaryOf VEVConf ig(KRZ_Al . StandardConf ig) ; // print withU(l)s 

27 SConfig VEVConfig = KRZ_A1 . StandardConf ig; // create new vev-config. 

28 VEVConf ig.Conf igLabel = "TestConf ig" ; // rename new vev-config. 
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29 VEVConfig. SymmetryGroup. observable_sector_Uls . clear () ; // change obs . sector 

30 Print .PrintSummaryOfVEVConf ig (VEVConfig) ; // print without U(l)s 

31 

32 cout << "-> Analyze model:" << endl; 

33 vector<SConf ig> AllVEVConf igs ; 

34 bool SM = true; // look for SM 

35 bool PS = true; // look for PS models 

36 bool SU5 = true; // look for SU(5) models 

37 // analyze the configuration "KRZ_A1 . StandardConf ig" of "KRZ_A1" 

38 // and save the result to "AllVEVConf igs" 

39 CAnalyseModel Analyze; 

40 Analyze. AnalyseModel (KRZ_A1 , KRZ_A1 . StandardConf ig, SM, PS, SU5, 

41 AllVEVConf igs, Print); 

42 if (SM II PS || SU5) // if one of the three possibilities is true 

43 { 

44 cout << "-> Model has 3 generations plus vector-like exotics:" << endl; 

45 const size_t si = AllVEVConf igs . sizeO ; // print all new configs. 

46 for (unsigned i = 0; i < si; ++i) 

47 Pr int. PrintSummaryOf VEVConfig (AllVEVConf igs [i] , LeftChiral, true); 

48 } 

49 } 

50 return EXIT_SUCCESS ; 



51 } 

First, we define an if stream object called in that contains the model file modelKRZ_Al .txt. Then, we 
define the orbifold group as a COrbif oldGroup object and load the content of in. If no error occurs, the 
orbifold is defined as a COrbif old object. After calling the constructor of COrbif old with a COrbif oldGroup 
parameter, the spectrum of the orbifold model is computed and checked for consistency. Next, we print the 
shift, the Wilson lines and the massless spectrum of the model using the CPrint class. In the last part, 
a CAnalyseModel object is constructed in order to analyze the phenomenological properties of the vev- 
configuration KRZ_A1 . StandardConf ig. 

Appendix B. Glossary of commands 

In this appendix, we give short explanations for all commands of the prompt and of the web interface. 
In Appendix B.l we start with some concepts and general commands. Then, in Appendix B.2 we list all 
commands available in the various directories of the prompt. 

Appendix B.l. Concepts and general commands 

The basic quantities of the prompt are fields of the 4D effective field theory (Appendix B. 1. 1). In order 
to access them easily one can define sets of fields (Appendix B.l. 2). Furthermore, gauge invariant monomi- 
als of fields are used to describe solutions of the D = condition (Appendix B.1.3). For many commands 
dealing with fields one can use the parameter if (condition) to choose only those fields that fulfill the 
condition (Appendix B.1.4). Finally, this section describes the concept of processes (Appendix B.l. 5), 
the use of vectors (Appendix B.1.6), how to change the typesetting to mathematica or to latex style 
(Appendix B.1.7), the use of system commands and variables (Appendix B.1.8). 
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Appendix B.l.l. Field labels 

For a given orbifold model and vev-configuration, fields of the 4D effective field theory are tagged with 
labels, for example q_l, q_2 and q_3 for the three left-handed quark doublets. A label consists of a name 
(q) and a generation index (1, 2 and 3 in our example). One can access several fields simultaneously using 
their common name, for example q for the three quarks. Furthermore, one can access all fields of a given 
model using *. In addition, one can obtain the intersection of all fields named A but not named B using A-B. 
Examples for intersections are: n-n_l to get all fields named n except for n_l and *-n for all fields except 
for the ones named n. 

Field labels are stored in the currently used vev-configuration of the orbifold model. They can be 
viewed and changed in the directory /vev-conf ig/labels>, see Appendix B.2.7. Note that in a given 
vev-configuration one can define several labels for each field. 

Finally, in mathematica typesetting, for example, the label q_l is displayed as f ldql. 

Appendix B.l.l. Sets of fields 

One can access several fields simultaneously not only by their field labels but also using sets of fields. 
These sets are stored in the currently used vev-configuration of the orbifold model. (Consequently, one 
cannot access a set in a different vev-configuration than in the one where it was created.) For more details 
on vacua, see Appendix B.2.6. Note that sets are on the same footing as field labels 1 . I.e. one can build 
intersections like: 

• A-B for the intersection of two sets A and B, 

• *-A for the intersection of all fields * and a set A, 

• A-q for the intersection of a set A and all fields of name q or 

• q-A for the intersection of all fields of name q and a set A. 

The commands to create and manipulate sets are displayed in any orbifold model directory of the prompt 
using the command 

help sets . (B.l) 

The commands are: 

Command create set (SetLabel). Create an empty set with name SetLabel and save it in the currently 
used vev-configuration. Optionally, this command allows for the parameters from monomials or from 
monomial (MonomialLabel) in which case all fields from either all monomials or only from monomial 
MonomialLabel will be inserted into the new set. See Appendix B.1.3 for more details on monomials. 

Command delete set (SetLabel). Delete the set SetLabel of the currently used vev-configuration. 

Command delete sets. Delete all sets of the currently used vev-configuration. 

Command insert (fields) into set (SetLabel). Insert fields into the set SetLabel. Optionally, the 
parameter if (condition) can be used to insert only those fields into the set SetLabel that satisfy the 
condition. For details on if (condition) see Appendix B.1.4. 



'Both, fields and sets of fields, will be denoted as fields in the explanations of the following sections. 
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command 


description 


create set(Test) 

insert(F_l F_2 F_3 F_4 F_5) into set(Test) 
remove(*) from set(Test) if(#osci. != 0) 
print sets 


create an empty set named Test 

insert F_i, i = 1 5 into the set Test 

remove fields with non-zero number operator N (i.e. F_5) 
print all sets 



Table B.2: Short example for the use of set-commands in the directory /Z3StandardEmbedding>of the W, 3 standard embedding 
model (using the standard labels F_i of the vev-configuration TestConf igl). 

Command print set (SetLabel). Print the content of the set SetLabel. 

Command print sets. Print all sets defined in the currently used vev-configuration. One can use the 
optional parameter if not empty to print only the non-empty sets. 

Command remove(f ields) from set (SetLabel). Remove fields from the set SetLabel. Optionally, the 
parameter if (condition) can be used to remove only those fields that satisfy the condition. 

Command # fields in set (SetLabel). Count the number of fields in the set SetLabel. 
A short example showing some of the basic commands for sets is given in Tab. B.2. 

Appendix B.1.3. Gauge invariant monomials 

(Holomorphic) gauge invariant monomials (short: monomials) are used to describe solutions to the 
D = supersymmetry condition [67, 68, 69, 70]. A (sub-)set of solutions can be found using the command 
find D-flat (fields) described in Appendix B.2. 6. More details and examples can be seen using the 
command 

help monomials (B.2) 

in any orbifold model directory. 

Appendix B.1.4. If conditions 

Many commands that deal with fields allow for the parameter if (condition) (or several copies thereof) 
so that only those fields are chosen that fulfill all the conditions. An explicit example was already given in 
Tab. B.2. In general, a condition consists of three parts: 

• the left hand side gives the variable (e.g. Q_i for the fields i-th U(l) charge, vev for the fields vacuum 
expectation value or #osci . for the number of oscillators), 

• the middle gives the comparison operator (e.g. == for equal or ! = for unequal) and 

• the right hand side gives a value (e.g. a rational number or 0). 
More details and examples can be seen using the command 

help conditions (B.3) 

in any orbifold model directory. 
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Appendix B.1.5. Processes 

The following commands start new processes that run in the background so that one can continue to 
work with the prompt: 

• /> create random orbifold f rom(0rbif oldLabel) 

• /A/couplings> create coupling(f ields) 

• /A/vev-conf ig> find D-flat (fields) 

• /A/gauge group> find accidental Uls 

Each process has an ID, the so called PID. Similar to the Linux command line one can see all running 
processes using the command ps and terminate a process with PID A using kill (A). One can also kill all 
active processes using the command kill (all) . In a script the command wait (X) might be useful in order 
to check every X seconds if all processes have finished and to continue with the next commands afterwards. 
More details can be seen using the command 

help processes (B.4) 

in any orbifold model directory. 
Appendix B.1.6. Vectors 

Many commands need a vector of rational numbers as a parameter. Examples include the commands 
set shift V(i) = <16D vector> and set torsion b = <6D vector>. In these cases there are several 
possibilities of how to write the vector. For example, the following forms of a <4D vector> are possible: 

(1/3 1/1 0/1 0/1) - (1/3 1 0) - (1/3,1,0,0) - (1/3,1,0*2) - 1/3(1 3 0*2) (B.5) 

In addition, for the first four forms of the example-vector, one can leave the brackets away. 

Appendix B.l. 7. Output for mathematica or in latex style 

Often it is useful to transfer data from the orbif older to mathematica, for example, in order to use 
STRINGVACUA [71], SINGULAR [72], NonAbelianHilbert [69, 70] or DiscreteBreaking [73, 74]. Therefore, 
many commands allow for the parameter 

Omathematica (B.6) 

so that the output of the command will be printed in a mathematica compatible style (if available). For 
example, 

print list of charges Omathematica (B.7) 

in the directory /spectrum>. Similarly, the parameter Olatex can be used in order to get the output in latex 
code (again, if available). In addition, one can set the default typesetting to mathematica, latex or back to 
standard using the commands 

Otypesetting(mathematica), Otypesetting(latex) or Otypesetting (standard) , (B.8) 

respectively. Finally, the parameter no output can be used to suppress the output of the current command. 
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Appendix B.1.8. System commands and variables 

System commands start with the symbol @ and are used to change the output's style and destination. 
Moreover, the prompt allows for some pre-defined variables which are particularly usefull in scripts. They 
start and end with the symbol $. 

Command ©typesetting (Type). Change the output's typesetting, see Appendix B.1.7. 

Command Obegin print to file (A). Start printing output to file A and not to the screen. In contrast, one 
can use the parameter to file (A) so that the output of only the current command is printed to file, e.g. 
print summary to file (Summary . txt) . 

Command Send print to file. Stop printing output to file. 

Command @status. Display the destination of the output (e.g. screen) and the style of the typesetting (i.e. 
standard, latex or mathematical 

Variables. There are three pre-defined variables: $0rbif oldLabel$, $VEVConf igLabel$ and $Directory$. 
When executed, a variable is replaced by a corresponding string, being the label of the current orbifold 
model, the label of the current vev-configuration or the path of the current directory, respectively. They are 
particularly usefull in scripts, e.g. used as to f ile($OrbifoldLabel$.txt). 

Appendix B.2. The directories 

The structure of the prompt consists of a main directory /> and subdirectories that correspond to orbifold 
models. Each orbifold model directory has further subdirectories /model>, /gauge group>, /spectrum>, 
/couplings> and /vev-conf ig>. They offer commands of the respective category. In this section we give 
an alphabetically ordered glossary of directory-commands and explain their use in detail. 

Appendix B.2.1. The main directory /> 

In the main directory one can basically create, load and save orbifold models. 

Command create orbif old(0rbif oldLabel) with point group(M,N). Create an empty orbifold model 
directory for an orbifold of specified point group orders (use N= 1 for orbifolds). 

Command create random orbifold from(0rbif oldLabel). Randomly create new orbifold models. De- 
tails are given in Section 4.1.2. More details and examples can be seen using the main directory's /> 
command 

help create random . (B.9) 

Command delete orbif old(0rbif oldLabel). Delete the orbifold model directory Drbif oldLabel. 
Command delete orbifolds. Delete all orbifold model directories. 

Command load orbif olds (Filename). Load all orbifold models from the model file named Filename. 

Command load program (Filename). Load a script from file Filename and execute the commands con- 
tained in that file. 



Command save orbif olds (Filename). Save all orbifold models of the main directory to a model file 
named Filename. 
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Appendix B.2.2. The directory /model> 

In the directory /model> the input data (e.g. point group, twists, shifts, Wilson lines, etc.) of the current 
orbifold model can be displayed and changed. 

Command create suborbifold with factor(i). Starting from an orbifold with space group S , one can 
create a so-called suborbifold based on a subgroup 5" c 5 . 

For orbifolds the subgroup 5 ' c 5 is specified by one number, i being a divisor of M. Denote the 
TLm twist generator of the space group by g e S . Then, the subgroup S ' c S is based on the twist generator 
g' e S' c S which generates %M/i- One can use the optional parameter and(j) to choose g l e S' c S and 
g J : e S' c S (with i, j coprime and i, j divide M) to generator 

In the case of IjmX^n orbifolds (with twist generators gi,g2 £ S) one has to specify two numbers 
create suborbifold with f actor (i, j) (where i divides M and j divides AO for the new generator g\g J 2 
of the subgroup S' c S . Again, one can use the optional parameter and(k.l) to specify a second generator 
g\g l 2 - 

Note that this command is particularly useful to analyze the 6D orbifold GUT limit of an orbifold model. 
For example, start with the ^6-11 orbifold MSSM of [40]. Then the command create suborbifold with 
factor (2) will produce the 6D Z3 orbifold GUT limit as analyzed in [75]. 

Command print available space groups. Print a list of all geometry files compatible with the speci- 
fied point group. The geometry files are searched by the orbif older in the directory /localdirectory/ 
Geometry> (of the local PC). For more details on the content of geometry files, see Section 4.4.1. 

Command print discrete symmetries. Print the discrete (R and non-/?) symmetries as defined in the 
geometry file. Note that R symmetries need to be defined in the geometry file in order to be used in the 
computation of allowed supeipotential couplings. 

Command print discrete torsion. Print the (generalized) discrete torsion parameters a, b a , c a and d a p 
as defined in Ref. [36]. 

Command print massless A-movers. where A can be left or right. Print the massless left- or right 
movers before some of them are projected out by the action of the centralizer. 

Command print orbifold label. Print the orbifold label (i.e. the name of the current orbifold directory). 

Command print point group. Print the point group. The output reads, for example, Point group is 
Z_3. 

Command print shift. Print the shift(s) as 16D vector(s). The output reads e.g. 

V_l = ( 1/3 1/3 -2/3 0000 0) (0000000 0) . (B.10) 

Command print space group. First, print the point group and the root-lattice. Next, print the generators 
of the space group. The output reads e.g. 

Space group based on Z_3 point group and root-lattice of SU(3)~3. (B.ll) 
Generators are: 
(1, 0) ( 0, 0, 0, 0, 0, 0) 
(0, 0) ( 1, 0, 0, 0, 0, 0) ■•■ 
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where (k,l) (n_l n_6) corresponds to the element (6^(j) l ,n a ea\ of the space group. Note that 

roto-translations and freely-acting involutions are allowed as generators of the space group. For exam- 
ple in Ref. [34], one of the generators of the (0-2) model reads (0,1) (0,0,0,0,1/2,0) corresponding to 
[io, \e$} and one of the generators of the (1-1) model reads (0 ,0) (0 , 1/2 , , 1/2 , , 1/2) corresponding to 

(l, \{e 2 +e 4 + e 6 )). 

Command print twist. Print the twist(s) as four-dimensional vector(s). The output reads e.g. 

v_l = ( 1/3 1/3 -2/3) . (B.12) 

Command print Wilson lines. Print the relations among the Wilson lines (e.g. W\ = W 2 for Z3), their 
order (e.g. order 3 for 3Wi e A for Z3) and the Wilson lines themselves as 16D vectors. The output reads, 
for example, 

Wilson lines identified on the orbifold: (B.13) 
W_l = W_2, W_3 = W_4, W_5 = W_6 

Allowed orders of the Wilson lines: 3 3 3 3 3 3 
W_l = (0000000 0) (0000000 0) 

Command print #SUSY. Print the number of supersymmetry in 4D. The output reads, for example, 

N = 1 SUSY in 4D. (B.14) 

Command set heterotic string type (type). Define the 16D gauge lattice of the heterotic orbifold 
model. Here, type can be E8xE8 or Spin32. 

Command set shift standard embedding. Choose V = (v 1 , v 2 , v 3 , 13 ) for orbifolds or V\ - 
(v},Vj,v 3 ,0 13 ), V 2 = 04,V2,v 3 ,0 13 ) for Z M xZ w orbifolds. (The notation 13 means 13 times the entry 
"0".) 

Command set shift V = <16D vector> or set shift V(i) = <16D vector>. Define the shift vector V 
of TLm orbifold models or one of the two shift vectors V; (with i= 1,2) of ZmX^jv orbifold models as 16D 
vector, see Eq. (1). For more details on vectors see Appendix B.1.6. 

Command set torsion a = n/d, b = <6D vector>, c = <6D vector> or d = <15D vector>. Set the 
(generalized) discrete torsion parameters as defined in [36], i.e. a, b a , c a and d a p (for a,f5 = 1,...,6; 
d a p - -dp a has 15 components). Note that the parameters are not checked for modular invariance and 
hence might cause inconsistent spectra. For more details on vectors see Appendix B.1.6. 

Command set WL W(i) = <16D vector>. Define the Wilson line Wi as a 16D vector (with i= 1, . . . , 6), 
see Eq. (1). For more details on vectors see Appendix B.1.6. 

Command use space group(i). with i= 1, Load the space group from the i-th geometry file, where 

the index i corresponds to the position in the list of geometry files as displayed using the command print 
available space groups. 
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Appendix B.2.3. The directory /gauge group> 

In this directory one can print and change some details of the gauge group for the currently used vev- 
configuration. In more detail, one can display the U(l) generators and the simple roots, change the basis 
of U(l) generators, define a B-L generator and identify accidental U(l) symmetries of the superpotential. 
Note that all gauge-group-editing commands are not available in the vev-configuration StandardConf igl. 

Command delete accidental Uls. Delete the accidental U(l) charges of all fields. 

Command find accidental Uls. Take the superpotential (as far as it has been created in the directory 
/couplings>, see Appendix B.2.5) and identify its accidental U(l) symmetries. The command starts a new 
process that runs in the back of the prompt. The results are saved in the currently used vev-configuration. 
Presumably, the accidental U(l) symmetries will be broken explicitly by higher order terms, but nevertheless 
might be of phenomenological relevance, e.g. for the strong CP problem [27] and proton decay [31]. 

Optionally, one can use the parameter fields with zero charge (fields) in order to find only those 
accidental U(l) symmetries under which the fields of fields are uncharged. On a technical level, this is 
achieved by inserting, during this analysis, each field of fields as a linear term into the superpotential. 

Command load accidental Uls (Filename). Load accidental U(l) charges from a file named Filename. 

Command print anomalous space group element. Print details on discrete anomalies using the discrete 
symmetries defined in the geometry file and identify the so-called anomalous space group element [76]. 

Command print anomaly info. Print details on gauge and gravitational anomalies and check their uni- 
versality relations. In detail, in the case of N = 1 SUSY in 4D, beside the pure non-Abelian anomalies, the 
relations 2 

1 _ 1 ^ 1 1 f const. ^ if i - 1 , i.e. / = anom . ,. 

Trtra = ntrQ- = -tr^Qf = ~tr<2;<2i = i n , (B.15) 

24 6\ti\ 2 1 2 2\tj\ 2 1 \ otherwise v ' 

(with i + j) are verified, where is a 16D vector corresponding to the i-th U(l) generator so that a field 
with shifted left-moving momentum p^ carries the charge <2, = p^ ■ f; and tr sums over the contributions 
from all massless left-chiral fields. 

Command print B-L generator. Print the U(1)b_l generator as a 16D vector. 

Command print FI term. Print the Fayet-Iliopoulos term (i.e. tr£2 anom as in Eq. (B.15)), if there is an 
anomalous U(l). 

Command print gauge group. Print the observable and hidden part of the gauge group for the currently 
used vev-configuration. 

Command print simple root(i). Print the i-th simple root as 16D vector. 

Command print simple roots. Print (a choice of) simple roots of all non-Abelian gauge group factors as 
16D vectors. 



2 In the orbif older, the convention for the quadratic Dynkin index is such that I - 1 for the fundamental 
representation of SU(A r ) groups. 
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Command print Ul generator (i). Print the i-th U(l) generator as 16D vector. 
Command print Ul generators. Print all U(l) generators as 16D vectors. 

Command save accidental Uls (Filename). Save the accidental U(l) charges to a file named Filename. 

Command set B-L = <16D vector>. Define U(1)b_l as a 16D vector. Since in the orbif older all U(l) 
generators are demanded to be orthogonal to each other, but U(l) b-l is in general not orthogonal to hyper- 
charge, B-L is stored as an additional vector. One can use the optional parameter allow for anomalous 
B-L if U(1)b_l is allowed to mix with the anomalous U(l). For more details on vectors see Appendix B.1.6. 

Command set Ul(i) = <16D vector>. Change the basis of U(l) generators by specifying a 16D vector as 
the i-th generator. The new generator must be orthogonal to all simple roots and to the j-th U(l) generator, 
for j < i. Note that the k-th U(l) generators with k > i will be changed automatically such that, at the end, 
all generators are orthogonal to each other. For more details on vectors see Appendix B.1.6. 

Appendix B.2.4. The directory /spectrum> 

This directory offers access to all information about the massless spectrum. In detail, for each mass- 
less field one can obtain the SUSY multiplet type (i.e. for N = 1 supersymmetry in 4D: lef t-chiral, 
right-chiral, vector and modulus), the localization (corresponding to its constructing space group ele- 
ment), the shifted left-moving momentum p s ^, the non-Abelian representation, the U(l) charges, the B-L 
charge (if defined), the shifted right-moving momentum q s h, the oscillator excitations, the R charges, mod- 
ular weights (if defined), the label of the field and finally its vev. Note that complex conjugate representa- 
tions are printed as negative integers; for example, -3 denotes the conjugate fundamental representation 3 
of SU(3). 

Command find potential blowup modes (fields). Print a list of potential blow-up modes considering 
fields only, i.e. print all fields for each fixed brane/point. 

Command find random blowup modes (fields), print a random list of blow-up modes fields, one per 
fixed brane/point. The result can be saved to a set SetLabel using the optional parameter save to 
set (SetLabel) . 

Command print (fields). Print some details of fields. There is one optional parameter, with internal 
information, that displays some internal information about how the fields' data can be accessed in the C++ 
source code of the orbif older. 

Command print all states. Print details of all fields (including left-chiral superfields, vector superfields 
of the (non-Abelian) gauge bosons, moduli and their CPT-partners). 

Command print list of empty fixed branes. Print a list of all fixed branes/points that potentially 
could carry left-chiral fields but are empty for the current orbifold model. 
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Command print list of charges (fields). Print gauge and discrete charges of fields. For example, 

( -1/3 -1/3 2/300000) (00000000) ( -1/3 2/3 -1/3) (2001) "F_10" (B.16) 
( -1/3 2/3 -1/3 0000 0) (0000000 0) ( -1/3 2/3 -1/3) (2001) "F_10" 
( 2/3 -1/3 -1/3 0000 0) (0000000 0) ( -1/3 2/3 -1/3) (2001) "F_10" 

for the field F_10 of the orbifold with standard embedding. Each line consists of three parts: 

• first the 16D shifted left-moving momentum (printed as two eight-dimensional vectors in the case 
of E 8 xE 8 ), 

• the R charges: {R\,B.2,Rt,) = (—4, 1, -h) in the example, 

• the charges with respect to the discrete non-R symmetries: (k, n\ + ri2, «3 + «4, n$ + n^,) - (2, 0, 0, 1) 
in the example, 

• the label of the corresponding field, 

where, in general, the R and non-7? symmetries must be specified in the geometry file, see Section 4.4.1. 
Note that it can be very helpful to use the optional parameter Omathematica for this command in order to 
transfer the information about the fields to mathematica, see Appendix B.1.7. 

Command print summary. Print the gauge group and a summary table of the massless matter fields. Im- 
portant optional parameters are: 

• of sectors 

• of fixed points 

• of fixed point (X) 

where the fixed point X can be specified in three ways: i) using k,l,nl,n2,n3,n4,n5,n6, ii) using 
loc of F_i where F_i is the label of a twisted field and iii) by a fixed point label as specified in the 
directory /vev-conf ig/labels>. 

• of sector T(k,l) where k and 1 label the B^co 1 twisted sector. Use of sector T(0,0) for the 
untwisted sector. 

In all these cases one can use in addition the following, optional parameters: 

• with labels: print the currently used labels of the fields as specified in the directory /vev-conf ig/ 
labels>. 

• no Uls: do not print the U(l) charges of the fields. 

• type of SUSY multiplet, e.g. vector, gravity, modulus or anykind for all types; if not specified the 
left-chiral fields are printed only. 

More details and examples can be seen using the command 

help print summary (B.17) 

in the directory /spectrum>. 
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Command tex table (fields). Print a latex table with information about fields. The table contains 
the (gauge) charges with respect to the observable sector of the currently used vev-configuration and the 
discrete charges as specified in the geometry file (see Section 4.4.1). One can use the optional parameter 
print labels (i , j , . . ) in order to list the i-th, j-th ... label(s) of the fields. 

Appendix B.2.5. The directory /couplings> 

The directory /couplings> allows to identify and analyze allowed terms of the superpotential (i.e. terms 
that are invariant under all gauge and discrete symmetries). The (in general moduli-dependent) coefficients 
are not computed. Furthermore, one can analyze mass matrices (e.g. of vector-like exotics). 

Note that couplings and mass matrices are stored in the currently used vev-configuration. Hence, they 
can only be accessed in the vev-configuration where they have been defined. For simplicity, the abbrevia- 
tions mm for mass matrix and mms for mass matrices apply to all commands. 

Command auto create mass matrix (A B). Create the couplings relevant for the effective mass matrix 
MjjAjBj. Optionally, one can specify the the label of those fields whose vevs generate My using the pa- 
rameter singlet (N) (with default value N=n) and the maximal order X in singlets N using the parameter max 
order (X). 

Command create coupling(f ields). Find the allowed superpotential-couplings between fields and 
store the result in the currently used vev-configuration. For example, all trilinear couplings are created 
using the command 

create coupling(* * *) . (B.18) 

Optionally, one can restrict fields using the parameter allowed f ields ( . . . ), e.g. the command create 
coupling(n n n) allowed f ields (SetA) creates all trilinear couplings of fields n from SetA. 

Command find(f ields). Displays a list of allowed couplings involving the fields fields. 

Command find effective(f ields). As find(f ields) , but only the effective couplings, i.e after replac- 
ing fields with non-zero vev by their vevs. 

Command load couplings (Filename). Load couplings from file Filename into the currently used vev- 
configuration. This command is disabled in the web interface. 

Command mass matrix (A B). Create the mass matrix MjjAjBj (from the current superpotential) and save 
it in the currently used vev-configuration. 

Command print effective superpotential. Similar to the command print superpotential but print 
only the effective couplings, i.e after replacing fields with non-zero vev by their vevs. 

Command print list of mass matrices. Print all mass matrices of the currently used vev-configuration. 

Command print mass matrix(i). Print the i-th mass matrix. The optional parameter max order(X) 
specifies the order X in the fields up to which a matrix entry shall be printed explicitly. 

Command print superpotential. Print the superpotential of the currently used vev-configuration. 

Command print vanishing couplings. Print all cases of vanishing couplings as lists of highest weights 
in Dynkin labels. See the command remove vanishing couplings. 
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Command remove vanishing couplings. Remove couplings that vanish because of symmetry/anti-sym- 
metry of repeated identical fields, e.g. let t be an SU(2) doublet, then the gauge invariant coupling it = 
iiije'i = vanishes. This command requires additional user input. 

Command save couplings (Filename). Save all couplings of the currently used vev-configuration to a 
file. One can optionally save only couplings of order X using the parameter of order (X). This command is 
disabled in the web interface. 

Appendix B.2.6. The directory /vev-conf ig> 

In this directory one can define several vev-configurations. Each of them is characterized by a choice 
of hidden and observable gauge group, a labeling of the fields and by their vev. In addition, one can 
analyze phenomenological properties and supersymmetric configurations (F = D = 0) in this directory and 
determine the unbroken gauge group of a given vev-configuration. 

For each orbifold model there are two standard vev-configurations: StandardConf igl and TestConf igl. 
The first one cannot be changed, but the latter one can be and is used as default. In both configurations the 
full gauge group is selected as the observable sector and fields are labeled F_l, F_2, F_3, . . ., all with zero 
vev. 

Note that the labels of the fields (see Appendix B.l.l), sets of fields (see Appendix B.1.2), monomials 
(see Appendix B.1.3), allowed couplings and mass matrices (created in the directory /couplings>) are 
saved in a vev-configuration. Hence, these data can only be accessed in the vev-configuration where they 
have been defined. In addition, note that all configuration-editing commands are not available in the vev- 
configuration StandardConf igl. 

Command analyze conf ig. Automatically check whether the current vev-configuration of the orbifold 
model allows for vacua with Standard Model, Pati-Salam or SU(5) gauge group, 

SU(3) C x SU(2) L x U(1) Y , SU(4) x SU(2) L x SU(2) R or SU(5) , (B.19) 

respectively, three generations of quarks and leptons and vector-like exotics. In the case the orbif older 
is not able to identify one of these possibilities for the current orbifold model one obtains the output No 
vev-configuration identified. Otherwise, corresponding new vacua will be created and convenient 
labels will be assigned to all matter fields (e.g. q_l, q_2 and q_3 for the three generations of quark doublets). 

The command allows for two optional parameters: print SU(5) simple roots to print the simple 
roots of an intermediate SU(5) group that has been used in order to identify the hypercharge generator and 
Xgenerations with X= 0, 1, 2, 3, ... to specify the (net) number of generations. 

Command compute F-terms. Compute the F-terms using the superpotential that was created for the cur- 
rently used vev-configuration (in the directory /couplings>. The optional parameter max order (X) allows 
to set an upper limit X on the order of superpotential couplings. 

Command create conf ig(Conf igLabel). Create a new vev-configuration. Optionally, one can specify 
the origin of the new vev-configuration using the parameter from (AnotherConf igLabel). If this parameter 
is not used the origin of the new vev-configuration is the standard vev-configuration StandardConf igl. 

Command delete conf ig(Conf igLabel). Delete the vev-configuration Conf igLabel. 
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Command find D-f lat (fields). Identify gauge invariant monomials of fields as solutions to the D = 
supersymmetry condition, see Appendix B.1.3. This command allows for two parameters: i) with FI to 
allow for monomials with non- vanishing anomalous U(l) charge in order to cancel the FI term and ii) save 
to set (SetLabel) to save those fields in a set called SetLabel that are involved in the new monomials. 

Command f ind unbroken gauge group. Depending on the vev assignment specified in the currently used 
vev-configuration, identify broken and unbroken (Abelian and non-Abelian) gauge group factors. In addi- 
tion, the U(l) charges of all fields are re-computed in the new U(l) basis. There is one optional parameter: 
print info to display some details. 

Command print gauge group. Print the choice of observable and hidden sector of the currently used vev- 
configuration, where the hidden sector gauge group factors are marked by brackets, e.g. [SU(4)] . 

Command print conf igs. Print an overview of all vacua defined for this orbifold model. The currently 
used vev-configuration is highlighted by an arrow -> in front, e.g. -> "TestConf igl". 

Command rename conf ig(DldConf igLabel) to (NewConf igLabel). Change the name of a vev-configura- 
tion from OldConf igLabel to NewConf igLabel. 

Command select observable sector: parameters. Assign a choice of observable and hidden gauge 
groups in the current vev-configuration. Admissible parameters are: 

• gauge group (i, j ,...), where the indices i, j = 1,2, .. . refer to the different non-Abelian gauge 
group factors sorted as displayed by print gauge group. The indices provided are chosen as part of 
the observable sector. 

• full gauge group All non-Abelian group factors are assigned as observable sector. 

• no gauge groups No non-Abelian group factor is assigned as part of the observable sector. 

• Uls (i , j , . . . ) , where the indices i , j = 1,2,... refer to the different U(l) gauge symmetries. The 
indices provided are chosen as part of the observable sector. 

• all Uls All U(l)s are assigned as part of the observable sector. 

• no Uls No U(l) is taken for the observable sector. 

For example, assuming that the gauge group is E6XSU(3)xEs, the instruction select observable sector : 
gauge group (1,2) selects EgxSU(3) as the observable and Eg as the hidden gauge groups. 

Command use conf ig (Conf igLabel). Change the currently used vev-configuration to Conf igLabel. 

Command vev(f ields) = .... Change the vevs of fields to new values. For example, vev(*) = turns 
off the vev of all fields, vev(SetA) = rand assigns random vevs to the fields of the set SetA and vev(n_l) 
= 0.1 sets the vev of n_l to 0. 1 . 

Appendix B.2.7. The directory /vev-conf ig/labels> 

In this directory one can define, for each vev-configuration, appropriate labels for the fields. The main 
commands are print labels and create labels. In both cases, a summary table of massless fields is 
printed, sorted by those representations and U(l) charges that belong to the observable sector of the currently 
used vev-configuration. The observable sector can be changed using the command select observable 
sector: ... in the directory /vev-conf ig>, see Appendix B.2.6. 
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Command change label (A_i) to (B_j ) . Change the label of the field A_i to B_j . 

Command assign label(Label) to fixed point(k,l,nl,n2,n3,n4,n5, n6). Assign Label to the fixed 
brane/point specified by (k,l,nl, n2,n3,n4,n5,n6). 

Command create labels. First, a summary table of massless fields is displayed. Then the user is asked 
to specify a name for each line of the table. 

Command load labels (Filename). Load labels from the file named Filename. This command is disabled 
in the web interface. 

Command print labels. Print a summary table of the currently used labels displaying the gauge repre- 
sentations with respect to the observable sector only. 

Command save labels (Filename). Save the labels to the file named Filename. This command is disabled 
in the web interface. 

Command use label (i). Change the currently used labels to the i-th labeling. 
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